Skip to main content

Gửi tin nhắn bắt đầu phiên

Đây là một loại tin nhắn đặc biệt để phục vụ cho việc khởi tạo phiên trong đoạn hội thoại.

HTTP request

POST https://{app_id}.api.piscale.com/chat-bot/v1.0/messages

Request body

Ví dụ
{
"thread_id": "",
"ext_user_ids": ["6872016393206779"],
"user_ids": [],
"body": {
"text": "Bắt đầu phiên",
"metadata": [
{
"type": "start_session"
}
]
}
}
TênKiểu dữ liệuMô tảBắt buộc
thread_idstringMã cuộc hội thoại
ext_user_idsarrayDanh sách ext_user_id
user_idsarrayDanh sách user_id
body.textstringNội dung văn bản
body.metadataarrayDanh sách hình ảnh
note
  • Bắt buộc thread_id hoặc ext_user_ids hoặc user_ids phải có dữ liệu.
  • Đích đến của tin nhắn sẽ được ưu tiên theo thứ tự thread_id, ext_user_ids, user_ids.
  • ext_user_ids tối đa 1000 phần tử.
  • user_ids tối đa 100 phần tử.

Giải thích các thuộc tính của metadata:

TênKiểu dữ liệuMô tảBắt buộc
typestringPhải là start_session

Response

Nếu thành công, bạn sẽ nhận được phản hồi.

Ví dụ
{
"message_code": "M200",
"message": "Success"
}
TênKiểu dữ liệuMô tả
message_codestringMã thông điệp. Xem chi tiết
messagestringNội dung mã thông điệp